/*
 * 版权所有 (c) 2001, 2010, Oracle 和/或其附属公司。保留所有权利。
 * ORACLE 专有/机密。使用须遵守许可条款。
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 */

package jdk.io;

/**
 * 用于在大端字节序的字节数组中打包/解包基本类型值的工具方法。
 */
class Bits {

    /*
     * 用于从给定偏移量的字节数组中解包原始值的方法。
     */

    /**
     * 从字节数组的指定偏移量获取布尔值。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @return 布尔值
     */
    static boolean getBoolean(byte[] b, int off) {
        return b[off] != 0;
    }

    /**
     * 从字节数组的指定偏移量获取字符值。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @return 字符值
     */
    static char getChar(byte[] b, int off) {
        return (char) ((b[off + 1] & 0xFF) +
                       (b[off] << 8));
    }

    /**
     * 从字节数组的指定偏移量获取短整型值。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @return 短整型值
     */
    static short getShort(byte[] b, int off) {
        return (short) ((b[off + 1] & 0xFF) +
                        (b[off] << 8));
    }

    /**
     * 从字节数组的指定偏移量获取整型值。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @return 整型值
     */
    static int getInt(byte[] b, int off) {
        return ((b[off + 3] & 0xFF)      ) +
               ((b[off + 2] & 0xFF) <<  8) +
               ((b[off + 1] & 0xFF) << 16) +
               ((b[off    ]       ) << 24);
    }

    /**
     * 从字节数组的指定偏移量获取浮点型值。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @return 浮点型值
     */
    static float getFloat(byte[] b, int off) {
        return Float.intBitsToFloat(getInt(b, off));
    }

    /**
     * 从字节数组的指定偏移量获取长整型值。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @return 长整型值
     */
    static long getLong(byte[] b, int off) {
        return ((b[off + 7] & 0xFFL)      ) +
               ((b[off + 6] & 0xFFL) <<  8) +
               ((b[off + 5] & 0xFFL) << 16) +
               ((b[off + 4] & 0xFFL) << 24) +
               ((b[off + 3] & 0xFFL) << 32) +
               ((b[off + 2] & 0xFFL) << 40) +
               ((b[off + 1] & 0xFFL) << 48) +
               (((long) b[off])      << 56);
    }

    /**
     * 从字节数组的指定偏移量获取双精度浮点型值。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @return 双精度浮点型值
     */
    static double getDouble(byte[] b, int off) {
        return Double.longBitsToDouble(getLong(b, off));
    }

    /*
     * 用于将原始值打包到给定偏移量的字节数组中的方法。
     */

    /**
     * 将布尔值写入字节数组的指定偏移量。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @param val 布尔值
     */
    static void putBoolean(byte[] b, int off, boolean val) {
        b[off] = (byte) (val ? 1 : 0);
    }

    /**
     * 将字符值写入字节数组的指定偏移量。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @param val 字符值
     */
    static void putChar(byte[] b, int off, char val) {
        b[off + 1] = (byte) (val      );
        b[off    ] = (byte) (val >>> 8);
    }

    /**
     * 将短整型值写入字节数组的指定偏移量。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @param val 短整型值
     */
    static void putShort(byte[] b, int off, short val) {
        b[off + 1] = (byte) (val      );
        b[off    ] = (byte) (val >>> 8);
    }

    /**
     * 将整型值写入字节数组的指定偏移量。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @param val 整型值
     */
    static void putInt(byte[] b, int off, int val) {
        b[off + 3] = (byte) (val       );
        b[off + 2] = (byte) (val >>>  8);
        b[off + 1] = (byte) (val >>> 16);
        b[off    ] = (byte) (val >>> 24);
    }

    /**
     * 将浮点型值写入字节数组的指定偏移量。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @param val 浮点型值
     */
    static void putFloat(byte[] b, int off, float val) {
        putInt(b, off,  Float.floatToIntBits(val));
    }

    /**
     * 将长整型值写入字节数组的指定偏移量。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @param val 长整型值
     */
    static void putLong(byte[] b, int off, long val) {
        b[off + 7] = (byte) (val       );
        b[off + 6] = (byte) (val >>>  8);
        b[off + 5] = (byte) (val >>> 16);
        b[off + 4] = (byte) (val >>> 24);
        b[off + 3] = (byte) (val >>> 32);
        b[off + 2] = (byte) (val >>> 40);
        b[off + 1] = (byte) (val >>> 48);
        b[off    ] = (byte) (val >>> 56);
    }

    /**
     * 将双精度浮点型值写入字节数组的指定偏移量。
     *
     * @param b 字节数组
     * @param off 偏移量
     * @param val 双精度浮点型值
     */
    static void putDouble(byte[] b, int off, double val) {
        putLong(b, off, Double.doubleToLongBits(val));
    }
}
